Introduction

This page describes how to automatically reload the configuration for both IdP and SP in JBoss Enterprise Application Platform 6 and beyond.

This configuration option allows you to change the configuration without restart the applications to make them take effect. You can even specify an external configuration file, from outside your deployment, that you may want to use to configure your IdP or SP.

Configuration

Regardless if you are enabling this option in a IdP or SP, the configuration is the same. Change your /WEB-INF/jboss-web.xml as follows:

<valve>
    <class-name>org.picketlink.identity.federation.bindings.tomcat.idp.IDPWebBrowserSSOValve</class-name>
    <param>
        <param-name>timerInterval</param-name>
        <param-value>30000</param-value>
    </param>
    <param>
        <param-name>configFile</param-name>
        <param-value>/java/sso/config/picketlink-idp.xml</param-value>
    </param>
</valve>

The example above demonstrates how to configure two parameters for a specific PicketLink Authenticator. In this case, the IDPWebBrowserSSOValve.

The first parameter is timerInterval, which allows you to specify a time value in milliseconds. The amount of time defines how much the configuration will be reloaded from time to time.

The configFile parameter is used here to specify a specific location for the picketlink.xml configuration file. Useful when you want to externalize the configuration for you IdP and SP.